GdPicture.NET.14.API
GdPicture14 Namespace / GdPictureImaging Class / OMRDetectMarks Method / OMRDetectMarks(Int32,GdPictureRectangle[],Int32,Double,Int32[]) Method
GdPicture image identifier.
Array of Rectangle. This parameter is used as a reference to the location of the OMR Fields. Where each Rectangle in the Areas, corresponds to a rectangle surrounding a single OMR field. For example, if 10 Rectangles exist in Areas, there will be 10 OMR Fields to be investigated whether they were checked (filled) or not.
Number of Rectangles sent to the method. Basically, the length of Areas().
How sensitive the method is to degree of filling of the OMR field in respect to the size of the field itself. Higher values will result in more tolerant results where semi filling of the field would yield positive results. Lower values will result in less tolerant results where maximum filling of the field only would yield positive results Sensitivity greatly affects the confidence value returned. Range from 0.0 to 1.0. If different values are entered, they will automatically be limited to this range. Default Value is 0.5.
Reference to a 1-Dimensional array of Integers. Must be initialized and sent to method. After the method is called, the array elements would correspond to the confidence of the result returned by the method. For Examples, if Confidence[0] = 40, then the first OMR field result returned is 40% accurate. It is important to mark that Confidence is greatly affected by "Sensitivity". Confidence value is a mixture of how much the sensitivity standard was accomplished, how much was it exceeded or unmet. It also details the respect of the filling to the size of the border and the regularity of the border.
Example





In This Topic
OMRDetectMarks(Int32,GdPictureRectangle[],Int32,Double,Int32[]) Method
In This Topic
Returns whether a selected OMR (Optical Mark Recognition) field/s is filled or not, with Sensitivity Control and Confidence Level returned. This method is mainly used for Square and Perfectly Circular Fields. An OMR field can be a checkbox, a fill-in-area checkbox, areas on a multiple choice examination form, or any area where highlighting is required to indicate a certain choice.
Syntax
'Declaration
 
Public Overloads Function OMRDetectMarks( _
   ByVal ImageID As Integer, _
   ByVal Areas() As GdPictureRectangle, _
   ByVal AreasCount As Integer, _
   ByVal Sensitivity As Double, _
   ByVal Confidence() As Integer _
) As Integer()
public int[] OMRDetectMarks( 
   int ImageID,
   GdPictureRectangle[] Areas,
   int AreasCount,
   double Sensitivity,
   int[] Confidence
)
public function OMRDetectMarks( 
    ImageID: Integer;
    Areas: GdPictureRectanglearray of;
    AreasCount: Integer;
    Sensitivity: Double;
    Confidence: Integerarray of
): array of Integer; 
public function OMRDetectMarks( 
   ImageID : int,
   Areas : GdPictureRectangle[],
   AreasCount : int,
   Sensitivity : double,
   Confidence : int[]
) : int[];
public: int[]* OMRDetectMarks( 
   int ImageID,
   GdPictureRectangle*[]* Areas,
   int AreasCount,
   double Sensitivity,
   int[]* Confidence
) 
public:
array<int>^ OMRDetectMarks( 
   int ImageID,
   array<GdPictureRectangle^>^ Areas,
   int AreasCount,
   double Sensitivity,
   array<int>^ Confidence
) 

Parameters

ImageID
GdPicture image identifier.
Areas
Array of Rectangle. This parameter is used as a reference to the location of the OMR Fields. Where each Rectangle in the Areas, corresponds to a rectangle surrounding a single OMR field. For example, if 10 Rectangles exist in Areas, there will be 10 OMR Fields to be investigated whether they were checked (filled) or not.
AreasCount
Number of Rectangles sent to the method. Basically, the length of Areas().
Sensitivity
How sensitive the method is to degree of filling of the OMR field in respect to the size of the field itself. Higher values will result in more tolerant results where semi filling of the field would yield positive results. Lower values will result in less tolerant results where maximum filling of the field only would yield positive results Sensitivity greatly affects the confidence value returned. Range from 0.0 to 1.0. If different values are entered, they will automatically be limited to this range. Default Value is 0.5.
Confidence
Reference to a 1-Dimensional array of Integers. Must be initialized and sent to method. After the method is called, the array elements would correspond to the confidence of the result returned by the method. For Examples, if Confidence[0] = 40, then the first OMR field result returned is 40% accurate. It is important to mark that Confidence is greatly affected by "Sensitivity". Confidence value is a mixture of how much the sensitivity standard was accomplished, how much was it exceeded or unmet. It also details the respect of the filling to the size of the border and the regularity of the border.

Return Value

The method returns an Array of integers. If the value of an element is 0, then the field was not filled. If the value of an element is 1, then the field was filled. The Elements of the returned array will correspond to the Elements of the Rectangles Array Areas(). Where if the first element of the returned array[0] is 0, then the OMR field surrounded by the rectangle in the element of Areas[0] was not filled. Similarly, if the first element of the returned array[5] is 1, then the OMR field surrounded by the rectangle in the element of Areas[5] was filled.
Remarks

All Rectangles sent to the method via array Areas can be of any size or location, as long as they: 1. Surround the OMR Field completely. 2. Do not intersect with borders of OMR field. 3. Do not intersect with other objects in the document.

Closer, more accurate selection of those rectangles will yield faster and more accurate results.

"Sensitivity" affects the "Confidence" returned. Low Sensitivity would return high results of Confidence for empty fields, but low Confidence results for semi filled fields. High Sensitivity would return low results of Confidence for empty fields, but High Confidence results for semi filled fields. It is important to note that "Confidence" is the degree of confidence that sensitivity rules are met, and not the actual filling or not filling of the field. If sensitivity values do not correspond properly to the filling, the confidence would spell to the sensitivity value more than the actual filling or not filling of the field.

If many documents are scanned of the same form, and the scanning orientation or quality is not guaranteed, the GdPicture Anchoring System can be used to specify the orientation of each document and the translation made to each document from the one where the user selected their Areas (surrounding rectangles). Then you can manually change the rectangle arrays to each document via the data provided.

To obtain best and most accurate results, images have to be of good quality, at least 200 dpi is recommended.

This method is used in the "OMR" Demo.

This method requires the ADR & OMR component to run.

Example
Testing whether a selected OMR (Optical Mark Recognition) field/s is filled or not within a tiff.
using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    int imageID = gdpictureImaging.CreateGdPictureImageFromFile("image.tif", false);
 
    // Specifying rectangles for OMR.
    const int markCount = 3;
    Rectangle[] areas = new Rectangle[markCount];
    // Each mark uses a quadruplet for its location (left, top, width, height).
    areas[0] = new Rectangle(850, 1580, 30, 30); // First area left, top, width, height.
    areas[1] = new Rectangle(850, 1620, 30, 30); // Second area left, top, width, height.
    areas[2] = new Rectangle(850, 1660, 30, 30); // Third area left, top, width, height.
 
    int[] confidences = new int[markCount];
    int[] filled = gdpictureImaging.OMRDetectMarks(imageID, areas, markCount, 0.5, confidences);
 
    StringBuilder result = new StringBuilder();
    for (int index = 0; index < markCount; index++)
    {
        result.AppendLine("Index:" + index.ToString());
        result.AppendLine("Left:" + areas[index].X.ToString());
        result.AppendLine("Top:" + areas[index].Y.ToString());
        result.AppendLine("Width:" + areas[index].Width.ToString());
        result.AppendLine("Height:" + areas[index].Height.ToString());
        result.AppendLine("Confidence:" + confidences[index].ToString());
        result.AppendLine("Filled:" + filled[index].ToString());
        result.AppendLine();
    }
 
    MessageBox.Show(result.ToString(), "Result", MessageBoxButtons.OK, MessageBoxIcon.Information);
 
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}
See Also